PerformanceMaximizer


PerformanceMaximizer is the lightweight and automatic performance optimization plugin I designed for GTA V. What it does is that it monitors your system's performance in real-time and dynamically manages entity density to ensure stable framerates and smooth gameplay during heavy sessions.



Description


When running heavy mod packs or high-density traffic/pedestrian setups, FPS drops and crashes are frequent. This plugin tracks your average frame rate and scales down game world complexity (peds, vehicles, etc.) when your system struggles to keep up. It is based on a tracking system that determines whether your game is stable or not by reading the framerate.



How It Works


The script functions by monitoring your current frame rate (FPS) and comparing it against thresholds defined in your configuration file.


* State Monitoring: The plugin tracks FPS over a rolling average to avoid constant state switches.
* Performance States:
 -Normal: Default game behavior, density isn't changed.
 -Moderate: Triggered when performance dips, slightly lowers traffic and pedestrian density to achieve stability.
 -Critical: Triggered during severe performance drops; drastically reduces world density and performs targeted "purges" of distant ambient vehicles and peds to free up CPU/Memory cycles.

PS: You won't see peds or vehicles disappear right in front of you, it only purges entities that you cannot see. If it does happen, consult the troubleshooting section below.



Installation


Extract the contents of the download (IMPORTANT).
Copy PerformanceMaximizer.asi and PerformanceMaximizer.ini to your main game directory, where GTA5.exe is located.
Consult the .ini file and configure it to your needs.
Done! Start up your game and enjoy.

Requirements:

Script Hook V by Alexander Blade - https://www.dev-c.com/gtav/scripthookv/
ASI loader included with Script Hook V (dinput8.dll)


Recommended for heavily modded setups:

A modified gameconfig.xml, preferably one labeled for heavy modding.
HeapAdjuster - https://www.gta5-mods.com/tools/heapadjuster
Packfile Limit Adjuster - https://www.gta5-mods.com/tools/packfile-limit-adjuster
Resource Adjuster - https://www.gta5-mods.com/tools/resource-adjuster (ONLY IF YOU'RE HAVING TEXTURE LOSS PROBLEMS)
fwBoxStreamerVariable and decals limit patch - https://www.gta5-mods.com/tools/ymap-load-list-extent-limit-fix-fwboxstreamervariable-patch



Troubleshooting


* Log Files: If you experience issues, check the `PerformanceMaximizer.log` file in your root folder. It will record when the script transitions into a "Critical" state or performs an entity purge.
* Pop-in: If you notice entities "popping" out of existence too close to you, increase your "DetectionRange" in the .ini file or disable "Automatic Detection Range" and set a higher value to "DetectionRange".


DISCLAIMER:

Compatible with most SHV/GTA builds, provided that your SHV and game build versions match. Tested on build 3788 with a heavily modded LSPDFR setup.
If you encounter issues not listed in the troubleshooting section, DM me via Discord : iliane31 (please describe your issue properly and attach the LOG file with your DM or the content of it, i will not answer a vague DM)

I AM NOT RESPONSIBLE FOR ANY KIND OF HARDWARE OR GAME RELATED ISSUES. THIS PLUGIN IS PROVIDED "AS IS" WITHOUT ANY KIND OF WARRANTY. ALL SALES ARE FINAL. IF YOU'RE RUNNING INTO ISSUES, DM ME (see above)
YOU ARE NOT TO RE-DISTRIBUTE OR UNLOCK THIS PLUGIN IN ANY WAY

PerformanceMaximizer - BETA V1.0

© - by Pixel's Mods



















